…ng with braille

Link to issue number:

Fixes #17053

Summary of the issue:

Sometimes, it may be desirable tohear lines when navigating with braille.

Description of user facing changes

• A new command, not assigned to gestures, is available in the braille category to toggle speaking of lines/paragraphs when navigating with braille, to enable or disable this feature. A new checkbox for this has been added in the braille settings panel as well.

Description of development approach

• A new key for this feature has been added to configSpec.py. The value is a boolean (False by default).
• A new script has been added to globalCommands.py.
• A new function has been added to braille.py, to be used by next and previousLine functions, also modified so that info is expanded to the corresponding read unit, i.e., line or paragraph.
• The braille settings panel has a new checkbox to toggle this feature.

Testing strategy:

Tested manually in Notepad and Window console, with braille following caret, review cursor and automatic modes.
Also, checked that indentation is reported when reading by lines, not by paragraphs, as expected when unit is specified for speakTextInfo function.

Known issues with pull request:

None.

Code Review Checklist:

• Documentation:
  • Change log entry
  • User Documentation
  • Developer / Technical Documentation
  • Context sensitive help for GUI changes
• Testing:
  • Unit tests
  • System (end to end) tests
  • Manual testing
• UX of all users considered:
  • Speech
  • Braille
  • Low Vision
  • Different web browsers
  • Localization in other languages / culture than English
• API is compatible with existing add-ons.
• Security precautions taken.

@coderabbitai summary